home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Wildcat Gold - The Optical BBS
/
Wildcat Gold - The Optical BBS (The Golden ROM Series)(Volume 4 Number 1)(The Digital Publishing Company)(1992).ISO
/
sdn
/
stowa102.sdn
/
STOW120.EXE
/
STOWAWAY.DOC
< prev
Wrap
Text File
|
1991-11-01
|
198KB
|
4,492 lines
S T O W A W A Y
True Archival System for PC Systems
Version 1.2
Offered by: Patri-Soft
Copyright 1991 by Patri-Soft
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
Table of Contents
WARRANTY INFORMATION . . . . . . . . . . . . . . . . . . . . 1
About STOWAWAY's true archival system . . . . . . . . . . . . 2
STOWAWAY Features . . . . . . . . . . . . . . . . . . . . . . 3
Archiving with STOWAWAY . . . . . . . . . . . . . . . . . . . 5
SETTING UP THE SYSTEM FOR THE FIRST TIME . . . . . . . . . . 6
Installation from the distribution diskette . . . . . . 6
Setting system options . . . . . . . . . . . . . . . . . 7
Drive to archive to/from? . . . . . . . . . . . . . 7
Level of compression desired? . . . . . . . . . . . 8
Disk Capacity? . . . . . . . . . . . . . . . . . . 8
Enter descriptions when archiving? (Y/N/Ask) . . . 9
Perform a group archive? (Y/N/Ask) . . . . . . . . 9
Enter an expiration date? (Y/N) . . . . . . . . . 10
Verify archive data after it is written? (Y/N) . 10
Use DOS Verify feature? (Y/N) . . . . . . . . . . 10
Sound speaker tones when action needed? (Y/N) . . 11
Delete files after archival? (Y/N) . . . . . . . 11
Overlay files when restoring? (Y/N/Update/Ask) . 12
Test to verify installation . . . . . . . . . . . . . 12
Quick Start guide . . . . . . . . . . . . . . . . . . . . . 14
Starting STOWAWAY . . . . . . . . . . . . . . . . . . 14
Archiving files . . . . . . . . . . . . . . . . . . . 14
Starting from the menu . . . . . . . . . . . . . 14
Selecting files . . . . . . . . . . . . . . . . . 15
Changing directories to select from . . . . . . . 15
Viewing files . . . . . . . . . . . . . . . . . . 16
Associating a group name with files . . . . . . . 16
Archive processing . . . . . . . . . . . . . . . 16
Archive termination . . . . . . . . . . . . . . . 17
Restoring files . . . . . . . . . . . . . . . . . . . 17
Restoring files . . . . . . . . . . . . . . . . . 17
Initial restore file selection . . . . . . . . . 17
Selecting a group . . . . . . . . . . . . . . . . 18
Restore now or list specific files . . . . . . . 18
Selecting files from the selection list . . . . . 18
Restore processing . . . . . . . . . . . . . . . 19
Restore termination . . . . . . . . . . . . . . . 19
Archival Concepts . . . . . . . . . . . . . . . . . . . . . 20
i
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
Table of Contents
Archival vs Compression Systems . . . . . . . . . . . . . . 21
How STOWAWAY works . . . . . . . . . . . . . . . . . . . . 22
Archive Volumes . . . . . . . . . . . . . . . . . . . 22
Archive Sets . . . . . . . . . . . . . . . . . . . . . 22
Archive File Index . . . . . . . . . . . . . . . . . . 23
Archive File Expiration Dates . . . . . . . . . . . . 23
Other Archive Indexes . . . . . . . . . . . . . . . . 24
STOWAWAY reference . . . . . . . . . . . . . . . . . . . . 25
Prepare your set of archive volumes . . . . . . . . . 25
STOWAWAY's Main Menus . . . . . . . . . . . . . . . . . . . 26
ARCHIVE PROCESSING WITH MANUAL SELECTION . . . . . . . . . 27
Entering archive file descriptions . . . . . . . . . . 27
The Archive File Selection Display . . . . . . . . . . 28
Selecting Groups of Files for Archival . . . . . . . . 29
Archive File Selection keyboard usage . . . . . . . . 30
Selecting a directory structure to be archived . . . . 32
Completing file selection . . . . . . . . . . . . . . 32
ARCHIVE PROCESSING WITH AUTOMATIC SCANNING . . . . . . . . 33
Path to archive . . . . . . . . . . . . . . . . . . . 33
Pattern to archive . . . . . . . . . . . . . . . . . . 33
Files Older than . . . . . . . . . . . . . . . . . . . 34
Archive until this amount of freespace met . . . . . . 34
Select only files needing backup . . . . . . . . . . . 34
Reset ARCHIVE attribute after archival . . . . . . . . 35
SPECIFYING ARCHIVE GROUPS . . . . . . . . . . . . . . . . . 35
Archive groups . . . . . . . . . . . . . . . . . . . . 35
Adding an archive group . . . . . . . . . . . . . . . 36
Archive Processing . . . . . . . . . . . . . . . . . . . . 37
Status Bar . . . . . . . . . . . . . . . . . . . . . . 37
Totals . . . . . . . . . . . . . . . . . . . . . . . . 37
Current File . . . . . . . . . . . . . . . . . . . . . 38
Disk Statistics . . . . . . . . . . . . . . . . . . . 38
Request for archive volumes . . . . . . . . . . . . . 38
Recovering from disk write errors . . . . . . . . . . 39
Completing archive . . . . . . . . . . . . . . . . . . 40
Restore . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Entering Restore Selection Specifications . . . . . . 43
Selecting a Group to Restore . . . . . . . . . . . . . 45
ii
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
Table of Contents
Listing Files Selected for Restore . . . . . . . . . . 45
Restore File Select List Processing . . . . . . . . . 46
Starting Restore . . . . . . . . . . . . . . . . . . . 50
Restore Processing . . . . . . . . . . . . . . . . . . 51
Overlaying Files with duplicate Names . . . . . . . . 52
Completing Restore . . . . . . . . . . . . . . . . . . 53
Utility Functions . . . . . . . . . . . . . . . . . . . . . 54
Remove files after archival . . . . . . . . . . . . . 54
Delete files from archives . . . . . . . . . . . . . . 54
Verify archived files . . . . . . . . . . . . . . . . 55
Pack the archive index . . . . . . . . . . . . . . . . 57
Build index from archive volume . . . . . . . . . . . 58
Clean archive indexes . . . . . . . . . . . . . . . . 59
Set alternate display colors . . . . . . . . . . . . . 60
Command Line operation . . . . . . . . . . . . . . . . . . 62
command line format . . . . . . . . . . . . . . . . . 62
Command parameter explanations . . . . . . . . . . . . 62
Specifying options through DOS environment variables . . . 65
ARCHIVE MAINTENANCE . . . . . . . . . . . . . . . . . . . . 66
Multiple Archive sets . . . . . . . . . . . . . . . . 66
Backing up the indexes . . . . . . . . . . . . . . . . 67
Making copies of archive data . . . . . . . . . . . . 67
The Context Sensitive Help System . . . . . . . . . . . . . 68
HARDWARE/SOFTWARE COMPATIBILITY . . . . . . . . . . . . . . 69
Operating system compatibilities . . . . . . . . . . . 69
Archive device compatibilities . . . . . . . . . . . . 69
TROUBLESHOOTING . . . . . . . . . . . . . . . . . . . . . . 69
I/O errors on disks . . . . . . . . . . . . . . . . . 69
Error Messages . . . . . . . . . . . . . . . . . . . . 70
Technical Support . . . . . . . . . . . . . . . . . . . . . 70
iii
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
IMPORTANT WARRANTY INFORMATION
TRIAL USE (SHAREWARE EVALUATION VERSION) WARRANTY:
The Shareware evaluation (trial use) version is provided AS IS.
Patri-Soft MAKES NO WARRANTY OF ANY KIND, EXPRESSED OR IMPLIED,
INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY
AND/OR FITNESS FOR A PARTICULAR PURPOSE.
REGISTERED VERSION ONLY WARRANTY:
Patri-Soft warrants the physical diskette(s) and physical
documentation provided with registered versions to be free of
defects in materials and workmanship for a period of ninety days
from the date of registration. If Patri-Soft receives
notification within the warranty period of defects in materials
or workmanship, and such notification is determined by Patri-Soft
to be correct, Patri-Soft will replace the defective diskette(s)
or documentation.
The entire and exclusive liability and remedy for breach of this
Limited Warranty shall be limited to replacement of defective
diskette(s) or documentation and shall not include or extend to
any claim for or right to recover any other damages, including
but not limited to, loss of profit, data, or use of the software,
or special, incidental, or consequential damages or other similar
claims, even if Patri-Soft has been specifically advised of the
possibility of such damages. In no event will Patri-Soft's
liability for any damages to you or any other person ever exceed
the lower of suggested list price or actual price paid for the
license to use the software, regardless of any form of the claim.
Patri-Soft SPECIFICALLY DISCLAIMS ALL OTHER WARRANTIES, EXPRESSED
OR IMPLIED, INCLUDING BUT NOT LIMITED TO, ANY IMPLIED WARRANTY OF
MERCHANTABILITY AND/OR FITNESS FOR A PARTICULAR PURPOSE.
1
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
About STOWAWAY's true archival system
STOWAWAY is a personal archival system for your computer.
STOWAWAY releases space on your hard disk by archiving
inactive files to offline storage media such as diskette.
The files and software on our PC systems are changing at a
rapid pace. We are constantly creating new data, trying new
software, and updating old systems. Our hard disks become
vessels holding massive amounts of information we want to
keep at our fingertips. In our fast paced world, much of
what we use today is old tomorrow! Old data and software
clutter our hard disks files and do little more than take up
space. These files get in our way when we search for the
files we need.
Deleting old files is not a solution, as we may have use for
them in the future, so we end up purchasing more hard disk
space to increase our storage capacity.
Although we do have need for larger hard disk to accommodate
today's larger software and more complex systems, we can
also use what space we have more efficiently. Hard disks
are not good storage locations for inactive data. Inactive
data should be stored in a place where we no longer have to
deal with it each day, but still have access to it if
needed.
STOWAWAY is a solution to the storage and maintenance of
your inactive files. It manages the process of storing and
tracking inactive data on less expensive storage media such
as diskettes.
STOWAWAY automates the task of moving files to offline
storage and cataloging them so they may be quickly located
and restored when you need them. STOWAWAY is a data and
software archival system for your personal computer.
2
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
STOWAWAY Features
∙ Age and select files for archival automatically based
on your specification criteria.
∙ Select files to be archived from optional scrollable
selection lists.
∙ Locate archived files quickly using hard disk archive
indexes maintained by STOWAWAY.
∙ Formats new diskettes automatically when needed.
∙ Compresses the data for maximum use of storage.
∙ Recover files to their original or new location.
∙ Archive diskette, removable hard disks, or optical
disks.
∙ Transport archives to other systems using portable
archive volumes.
∙ Create multiple archive sets to keep archives for
different users on the same system.
∙ Assign archive files optional group names which provide
categories to keep and locate files with.
∙ Add optional descriptive text to archive files.
∙ Archive and restore directories or directory trees.
∙ Verify data is properly archived before deleting it.
∙ View WordPerfect and text files from file selection
lists to determine if a file is to be archived.
∙ Assign optional expiration dates to archived files so
they may be automatically deleted when no longer
needed.
∙ Run STOWAWAY using command line parameters or menus.
∙ Examine context sensitive help at any time.
∙ Copy archive volumes easily to offsite storage.
3
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
∙ Archive files in a network environment.
4
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
Archiving with STOWAWAY
STOWAWAY moves files to offline disks and keeps indexes to
them at your fingertips on your hard drive. You always have
the same access to inactive files that you had when they
were on your hard disk. The index is instantly accessible
to let you locate files. When you need a file again,
Stowaway will bring it back from storage for you.
STOWAWAY organizes your archives disks in a simple way so
you do not have to think about how to store your archives.
All archive disks are numbered sequentially starting from
one. Newly archived files are stored in compressed form on
the next available archive disk. Stowaway keeps track of
the disks by number and records information about the exact
location of every stored file in its index on the hard disk.
You store archive disks in numeric order. When restoring
files, STOWAWAY determines the exact disk the requested file
is stored on, and asks you for it by number. You easily
locate the disk, using its number, and place the disk in the
drive for reading.
This simple technique allows you to potentially keep
hundreds of disks of archive data and keep perfect track of
them.
Use STOWAWAY to save all your old and seldom used files.
Archive:
1. Old versions of software
2. Old documentation
3. Old data files
4. Old system configuration information
5. Picture and graphic files
STOWAWAY has many features to help you archive and keep
track of data efficiently. It will quickly become one of
your most valued utilities.
5
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
SETTING UP THE SYSTEM FOR THE FIRST TIME
Installation from the distribution diskette
To install STOWAWAY take the following steps...
1. Place distribution diskette in any diskette
drive.
2. Enter the following INSTALL command. If you
are not using drive A:, substitute the
appropriate drive letter as the first letter
in the command.
A:INSTALL
3. You will be asked to confirm the directory
name where Stowaway files are to be placed.
The default name is \STOW but you may chose
any alternate name you desire.
Once the installation is complete you will find the
following files installed in the selected directory on
your hard disk:
STOW.EXE The STOWAWAY program file
STOW.HLP Contains the context sensitive help
VENDOR.DOC Information for Shareware vendors
ORDER.DOC An order form for registering
STOWAWAY
The first time STOWAWAY is started it builds files it
needs for its general operation. They are:
STOSAWAY.DAT The options file. These options
are set using the Setup option from
the Stowaway menu.
STOVOLIX.DAT STOWAWAY's index containing
information about each archive
volume it maintains.
STOGRPIX.DAT STOWAWAY's index containing
information about each archive
group defined.
STOFILIX.DAT STOWAWAY's index containing
information about each file
maintained in the archives.
6
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
Note: Each of the installed file names begin with the
letters "STO". STOWAWAY allows multiple archive sets
to be created. Each set is assigned a three letter
identification. STOWAWAY's index and option file names
will be prefixed with the three letter identifier for
other archive sets created so these same files will be
duplicated with a different three character prefix for
alternate archive sets created. Alternate archive sets
will be discussed further in subsequent sections of
this manual.
Setting system options
STOWAWAY is now installed with default system options.
You should verify these options before continuing.
Change to the directory where STOWAWAY is installed and
enter the STOW command from the DOS command line:
C> STOW<Enter>
From STOWAWAY's Main Menu, select the Set Up function
by pressing 'S' or by positioning the selection bar
with the up and down cursor positioning keys and press
<Enter>.
You will be presented with a display of STOWAWAY's
options. Examine and modify the options as described
below. Additional help is always available by pressing
<F1> at any time.
┌──────────────────────────────────────────────────┐
│ Drive to archive to/from? │
└──────────────────────────────────────────────────┘
Enter the letter of the DOS device you will use to
write archive data. This may be the drive letter
of any valid DOS mountable disk device. You may
use 5 1/4 or 3 1/2 diskette formats or large
capacity demountable hard disk type devices.
7
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
┌──────────────────────────────────────────────────┐
│ Level of compression desired? │
└──────────────────────────────────────────────────┘
Use the Right and Left cursor positioning keys to
select the level of compression desired for data
written to the archives.
NONE Do not compress archive data.
Will provide the fastest
possible archiving but you
will use many archive disks.
MINIMUM Provides about 40% compression
on data but is not as slow as
higher compression levels.
STANDARD Provides about 45% compression
on data but is not as slow as
MAXIMUM compression.
MAXIMUM Provides 50-60% compression
but is slower than other
compression. This is the
recommended level of
compression to use.
┌──────────────────────────────────────────────────┐
│ Disk Capacity? │
└──────────────────────────────────────────────────┘
Specify the size of disk you will be using for
archival. Each archival disk should be the same
size. This size is used when STOWAWAY formats new
diskettes for the archives.
If you incorrectly specify a size of a high
density disk and place a low density disk in the
drive, STOWAWAY will format the disk as a high
density disk and format errors will be
encountered.
8
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
┌──────────────────────────────────────────────────┐
│ Enter descriptions when archiving? (Y/N/Ask) │
└──────────────────────────────────────────────────┘
Since filenames often are not descriptive enough
to help locate a file you want to restore, you
optionally can enter descriptive text for each
file archived. Descriptions are entered when
files are manually selected for archival.
Enter 'Y' if Stowaway is to prompt for descriptive
text for each file to be archived. When 'N' is
specified Stowaway will not prompt for
descriptions.
Enter 'A' to make Stowaway ask if descriptions are
to be entered before archive selection is started.
A value of <Yes> assumes descriptions are to be
asked for. Even with a value of <Yes>, you may
temporarily suspend entering descriptions for each
file by pressing <Escape> when the description is
requested. You will not be asked for descriptions
for subsequent files.
┌──────────────────────────────────────────────────┐
│ Perform a group archive? (Y/N/Ask) │
└──────────────────────────────────────────────────┘
After selecting one or more files to be archived,
you may assign a group name to the set of files.
This group name lets you categorize files in the
archives. When looking for files to restore, you
may search by group name and description as well
as filename or directory name.
Groups and their descriptions are saved by
STOWAWAY in its indexes. New groups may be added
at any time. When prompted for a group name, you
are presented with a scrollable selection list of
existing groups. You may select any defined group
or add a new group at any time.
Typical groups might be SPREADSHEET, GRAPHICS,
JOHN, LETTERS, MEMOS, HOME, CORPORATE, etc.
Enter 'Y' to be prompted to enter group
information for sets of files to be archived.
9
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
Specify 'A' to have Stowaway Ask if you want to
enter group names before each archive process.
Enter 'N' to indicate group names are not to be
associated with archived files.
┌──────────────────────────────────────────────────┐
│ Enter an expiration date? (Y/N) │
└──────────────────────────────────────────────────┘
Expiration dates may be optionally specified for
each set of files archived. Archive file
selection does not prompt for expiration dates for
files archived. You may enter an expiration date
by pressing <F8>. Enter 'Y' if you want Stowaway
to prompt for an expiration date to assign to each
set of files archived.
┌──────────────────────────────────────────────────┐
│ Verify archive data after it is written? (Y/N) │
└──────────────────────────────────────────────────┘
For data integrity, STOWAWAY can verify archive
disk data contents before removing the files from
your hard disk.
The verify process is performed just before you
are asked to remove an archive disk from the
drive. Verification rereads the entire disk to
make sure the data is readable.
┌──────────────────────────────────────────────────┐
│ Use DOS Verify feature? (Y/N) │
└──────────────────────────────────────────────────┘
DOS provides a Verify feature to check diskette
contents after writing to them. This feature adds
additional time to write diskette data but helps
to confirm all data written to diskettes is
complete and correct. This DOS feature may be
activated through the DOS VERIFY command and
documentation about it may be found in DOS
reference manuals.
Enter 'Y' for this option to have Stowaway
activate the DOS VERIFY feature during its
10
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
operation. This will help to insure all archive
data is written without errors. We recommend you
use this feature when archiving with Stowaway.
┌──────────────────────────────────────────────────┐
│ Sound speaker tones when action needed? (Y/N) │
└──────────────────────────────────────────────────┘
If you dislike the sounds STOWAWAY makes during
processing or just like a silently running
machine, specify <N> to have Stowaway disable all
speaker sounds during its operation.
If <Y> is specified, you will hear a quiet tic as
each file is archived. This gives you audible
signal that archive is currently working. You
will also be beeped whenever STOWAWAY is waiting
for you to take an action, such as placing another
diskette in the drive.
┌──────────────────────────────────────────────────┐
│ Delete files after archival? (Y/N) │
└──────────────────────────────────────────────────┘
Normally archival is the process of copying files
to another disk and then deleting them from your
hard disk. If you want to retain the files on your
hard disk after archiving them, specify <No>.
Specify <Ask> to indicate you desire to be
prompted before STOWAWAY deletes the files after
archival. At the prompt you may decide if the
files are to be deleted or not.
When experimenting with STOWAWAY, set this value
to <N>. You may then practice archival without
actually removing files from your system. STOWAWAY
comes with this option set to <N>. When you are
ready to start archiving, set this value to <Y> or
<A>.
A potential reason for archiving without deleting
is to use STOWAWAY to copy selected files to
diskette to take to another location. You still
want to keep the files on your current drive.
11
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
┌──────────────────────────────────────────────────┐
│ Overlay files when restoring? (Y/N/Update/Ask) │
└──────────────────────────────────────────────────┘
If during restore, Stowaway finds a hard disk file
that has the same name as the file being restored,
it must make a decision if the existing file is to
be replaced or the restore for the file bypassed.
Use the following options to indicate how STOWAWAY
is to process when files of duplicate names are
found during restore processing.
Yes Replace the existing file with the new
file.
No Don't overlay the existing file. Skip
the restore for the file and continue on
to restore other files.
Ask Stowaway is to immediately prompt you
when duplicate files are encountered and
ask if the file is to be replaced or the
restore of the file is to be skipped.
Update Automatically replace only those files
that are newer than the ones present on
the disk. The DOS directory date of the
file on the hard disk will be compared
to the DOS directory date of the archive
file recorded when the file was
originally archived.
Test to verify installation
After STOWAWAY is successfully installed you will want
to take a few minutes to learn how it works and develop
come confidence in it. You may test STOWAWAY without
actually archiving any data off your hard disk by
setting the "Delete files after archival" Setup option
to <N>.
Explore STOWAWAY's features by archiving and restoring
files and directories. When restoring files, always
specify an alternate restore target pathname so you
will not replace the files on your hard disk during
your evaluation of the system.
12
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
Since STOWAWAY allows multiple archive sets to be
created, you can create a special archive set to test
or demonstrate Stowaway. If you would like to use this
feature for your evaluation of Stowaway specify /ID:TMP
on the STOWAWAY command line or set a DOS environment
variable with the id.
SET STOW=/ID:TMP
You may delete the test archive set by using the Clean
option from Stowaway's utility menu.
Archive diskettes used for the test archive set may be
used for any other archive set. You do not need to
delete the files on them as STOWAWAY will remove files
from the disk before using them.
13
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
Quick Start guide
If you dislike reading manuals and want to get right to the
action, this section will get you started using STOWAWAY.
Remember the <F1> key provides direct access to information
about your current action in STOWAWAY. The context
sensitive help system provides complete information for
using the system.
Starting STOWAWAY
Use the STOW command to start STOWAWAY. STOWAWAY may
be started from any directory or disk. STOWAWAY uses
indexes and options from the directory \STOWAWAY.
You may place the STOWAWAY directory in your PATH
environment variable (see your DOS manual) or may
specify the pathname where the STOW command exists as
the command prefix. Following are some command
examples:
STOW
\STOW\STOW
D:\STOW\STOW
STOWAWAY can be run from the DOS command line using
command line parameters. Command line parameters are
documented later in this manual. This section assumes
you are using menus to direct STOWAWAY's operation.
We assume you have already used the Setup of the Main
Menu to specify system options. If you have not done
this yet, do it now.
Archiving files
1. Starting from the menu...
Select the Archive function from STOWAWAY's main
menu. You will be presented with a second menu to
select how files to be archived are to be
selected. Files can be automatically selected
based on entered specifications, or manually
select files from scrollable directory lists.
Choose the manual selection option for your
evaluation. This will give you a good idea of how
STOWAWAY works.
14
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
Depending on Setup options specified, you may be
asked the following question...
┌─────────────────────────────────────────┐
│ Do you want to enter descriptions for │
│ files to be archived? (Y/N) │
└─────────────────────────────────────────┘
Answer 'Y' if you want to manually enter a
description for one or more files to be archived.
2. Selecting files...
Next you will be presented with a display of files
from the current directory you were positioned on
when STOWAWAY was started. This is a selection
list to allow you to mark files to be archived.
Simply use the <Space Bar> to toggle your
selection on or off.
Depending on your selected options, STOWAWAY may
ask you to enter a description for any files you
mark to be archived. To ignore the description
for a single file, press <Enter> without entering
any data. To ignore entering descriptions for
this and all subsequent files, press the <Escape>
key.
File descriptions will assist you in locating
files at restore time. You will be able to browse
through description data as well as file names,
and directory names. If you take the time to
enter descriptions now, they will help you in the
future.
3. Changing directories to select from...
At the top of the scrollable list of files are
subdirectories defined within the directory.
These serve two purposes. First they can be
selected like files to mark an entire directory or
directory tree for archiving. Second, you can
position the selection bar on a directory name and
press <Enter> to change the list displayed to a
new directory.
15
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
STOWAWAY remembers all selected files even though
you may change directories. The upper right hand
portion of the display shows the total number of
files and amount of disk space to be freed as a
result of archival.
4. Viewing files...
Press <F1> for help with all the functions of the
selection screen. You can View WordPerfect or
text files by positioning the selection bar on
them and pressing <V>.
When you have marked some files for archival and
are ready to move to the next step press <F10>.
5. Associating a group name with files...
Depending on the setup options specified you may
be asked if you want to assign the selected files
for archival a group name. If you respond 'Y'
Stowaway will present you with a group selection
display.
Archive groups are a feature provided to help you
categorize your archive data more effectively.
Locating files by file and directory name may not
seem difficult at archival time but after a few
months you will appreciate any additional
organization implemented.
Enter any group name to be associated with the set
of files to be archived, and enter a description
to help explain the purpose of the group.
6. Archive processing...
Once you have entered group information the
archive process will begin. Stowaway will present
an archive status display. You will immediately
be asked to place an archive diskette in the
output disk drive. Place any formatted or
unformatted disk in the drive. IF THE DISK
CONTAINS DATA IT WILL BE ERASED! Press <Enter> to
indicate the disk is ready.
16
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
Archive processing will progress while continually
updating the status on the display. You will be
asked for additional disks as they are needed.
Label each archive volume with the number
indicated by STOWAWAY. It is usually sufficient
to place a label with a large number on it.
7. Archive termination...
When archive processing ends, STOWAWAY saves its
own indexes and options to the end of the archive
set in case you need to recover them at another
time. Remove the diskette from the drive when
STOWAWAY tells you to do so. Archive processing
has completed.
Restoring files
1. Restoring files...
Restore processing is very similar to archive
processing except you select files to be restored
from STOWAWAY's index of archived files. From the
STOWAWAY main menu, select restore to begin
restore processing.
2. Initial restore file selection...
There are three levels of file selection in
restore. Each successive level further isolates
files to be restored.
First you indicate any pathname or filename
wildcard entries to be used to select files to be
restored. On the same display you can specify
beginning and ending dates files must have been
last updated between to qualify for restore.
Press <F10> after entering the data. You don't
have to enter any data at this point, just press
<F10> to proceed to the next selection display.
17
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
3. Selecting a group...
If you have associated group names with any files
you archived you will be presented with a
selection display of all defined groups and asked
if you want to restore files from any particular
group. The first entry in this list is a generic
entry indicating to select files from all groups.
Other entries are for specific groups. Selecting
a specific group at this point will isolate the
files to be restored to files associated with that
group. Pressing <Enter> from this display will
move you to the next step in restore selection.
4. Restore now or list specific files...
STOWAWAY now asks if you want to restore the
qualifying files or to list them for further
selection.
At this point you have entered specifications to
qualify files to be restored. If you have already
entered enough information to have the proper
files restored you are ready to begin. Start the
restore by pressing <R>.
5. Selecting files from the selection list...
Selecting <L> for List will cause STOWAWAY to
locate all files that qualify your selection
criteria to this point. These files will be
displayed in a scrollable selection list. You may
mark any number of files to be restored. Use the
<Space Bar> to toggle selection on or off.
Use the <F1> key to see other features of the
restore selection display. You may sort the list,
zoom it larger to fill the display and display
alternate information about the archived data.
When finished with the selection list press <F10>
to begin restoring the selected files.
18
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
6. Restore processing...
The restore status display will be shown and you
will immediately be asked to place a specific
archive disk in the drive. Press <Enter> to
indicate the disk is ready. Restore will begin and
its status will be reported until all files are
processed.
7. Restore termination...
When restore completes STOWAWAY will display a
message indicating it is done. Remove the disk
from the drive and return it to your archive set.
That is all there is to basic STOWAWAY processing.
There are several features we have not mentioned in
this quick start section. Use the help system or
browse this manual to learn more about the system.
19
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
Archival Concepts
Hard disks are not intended to be repositories for a
lifetime of information. When we get a larger hard disk it
enables us to store more files but does not solve our
problem of managing inactive files. We keep all sorts of
files on our hard disks regardless of their importance. It
becomes convenient to save old copies of data just in case
we might need them. The disk space is there, why not use
it?
Unfortunately, we gradually consume the space on the disk
and begin looking for files to remove. We can immediately
delete some files as their value is gone. Others we may
compress to keep at our fingertips, while reducing the disk
space they require. When we have taken these actions and
still are short of disk space, we look for files to copy to
diskette for safe keeping.
This scenario demonstrates some of the basic parts of
computer disk storage management. They are:
1. Remove unneeded data by deleting it.
2. Compress data on primary storage when practical.
3. Move old or archive copies of data to less
expensive storage.
4. Purchase new primary storage only when necessary.
You might think that hard disks are not expensive, why not
just keep buying bigger ones? Purchasing additional disk
space might work for a while but there are other costs to
keeping data than just hard disk space.
Every file on your hard disk must be managed. It must be
kept track of as well as regularly backed up. The more
files we keep on our hard disk, the more work we have to do
to manage them. Archival is a procedure for moving data to
a special offline location where the cost of management and
storage is much less than on our hard disk. Archived data
is stored in a location we do not have to work with on a
day-to-day basis. Archived files no longer require repeated
backup, and they are filed properly once so they may be
easily found when needed.
A common use of archival is to save old generations of data.
For instance, you could keep a copy of a customer database
on a monthly basis. This lets you go back and restore the
database from any monthly copy. Backup systems cannot
20
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
provide this capability as they only keep one or two old
copies of data.
We use archival concepts in our everyday lives. For
example, the federal government requires us to keep years of
tax receipts for proof in case we are eventually audited.
We may keep our current years tax receipts and data in our
desk, but we typically don't have enough "desk" space to
hold several years of information. It is instead "archived"
to the closet or garage for storage. The garage holds more
information than the desk and is a less costly storage area.
Many computer users have implemented a simple archival
system of their own. It consists of using the DOS COPY
command to copy old files to diskette and then store the
disks in a safe location. This is a valid archive
technique; but often it is insufficient because we do not
take the time and effort to properly catalog and organize
the disks as we create them. We quickly discover this when
we go looking for a file we once saved to diskette and
cannot locate it.
STOWAWAY's archival system provides a methodology and
software to create and manage our archives for us. It is
implemented to make archiving data almost effortless. You
don't need to think of how to label or store archive
diskettes. When a file is needed, STOWAWAY helps locate it
quickly. STOWAWAY puts your computer to work for you to
manage your archive data.
Archival vs Compression Systems
Since modems were introduced and PC users began transmitting
files to other systems, file compression utilities were
developed to make the process more efficient. These
compression utilities compressed one or more files into a
single file that could be easily sent to another system.
Compression utilities were quickly found useful for storing
data in a format that used less disk space. They also had
the benefit of grouping compressed files together. This
provided a technique for more efficiently storing
collections of files.
Over the years different compression utilities have
proliferated. They have greatly improved in their
compression ability and speed but they provide the same
basic function.
21
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
Some of these utilities become known as archival systems
even though they only archive data in a crude sense. They
do not automate the storage and cataloging of data for a
user. They rely on the user to "archive" the compressed
files to offline storage using a backup facility or DOS COPY
command.
Compression systems provide valuable capabilities to the PC
user and allow for much more efficient use of hard disk
space, but their archival capabilities are limited and
should not substitute for a good archival system.
How STOWAWAY works
Archive Volumes
Different disk device types may be used to contain archival
data. These devices may include 3 1/2 diskettes, 5 1/4
diskettes, removable hard disk devices, optical disk
devices, and more. Due to this variety of archival storage
devices, any archive storage media is referred to by
STOWAWAY as an archive volume.
STOWAWAY archival processing takes the files you select and
writes them on archive volumes. Each file is written to
volume in a compressed format. Each STOWAWAY archive volume
contains two files. The first file is an archive volume
label file identifying the archive volume as well as
information about other volumes written before and after the
volume.
The second file on an archive volume contains all archive
data written to the volume. This file contains any number
of compressed archived files and corresponding information
needed to restore them. Since all files are written to a
single output file, archive disk space is saved and archive
performance is improved.
Archive Sets
A set of archive volumes is a series of numbered diskettes
or disk volumes containing archive data. Even though
STOWAWAY usually uses the volumes in numerical order, this
is not a requirement. To use volumes efficiently they are
completely filled before a new volume is requested.
Whenever a new archive process is started, STOWAWAY always
asks for the last archive volume used during the previous
22
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
archive. The user should not be concerned with how data is
stored in the archives. STOWAWAY is responsible for the
efficient use of archive space. It keeps track of all
archived files and their location.
Archive File Index
As files are archived, an entry for each file is placed in
an archive index maintained in the STOWAWAY directory on
your hard disk. This index is always maintained on the hard
disk and may grow to be fairly large. About 80 characters
of hard disk space is used for each file archived. The
archive index record contains all information necessary for
locating and restoring the file. The archive index makes it
possible for STOWAWAY to list archive files at your request
without having to read archive volumes.
When you restore a file, Stowaway uses its index to help you
locate files. When the exact files to be restored are
selected, information in the index identifies the exact
volumes needed to restore the file. STOWAWAY starts restore
processing and asks you to place specific volumes in the
drive as they are needed.
As you archive more and more data, the archives continue to
grow. Archive volumes are inexpensive as compared to hard
disk space; so, adding new volumes to the archives is not
costly. You may delete archive index entries to preserve
index disk space and clean up the archives. Subsequent
versions of STOWAWAY will allow you to reuse archive volumes
as the data on them is released.
Archive File Expiration Dates
You may optionally assign expiration dates to sets of files
archived. An expiration date is a date in the future when
the archived files can be automatically deleted from the
archives. Expiration dates are part of automated archival
management.
When you specify expiration dates to archive files, you are
giving STOWAWAY information that lets it automatically
manage archive files and are freeing yourself from the
burden of having to again examine the file at some later
time to determine if it is still needed. When the day of
the expiration date arrives, STOWAWAY can automatically
remove files from the archives.
23
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
Not all files will have expiration dates. Files with no
expiration dates will be kept indefinitely. Expiration
dates should be provided at archive time whenever possible
as they help to keep the archives uncluttered.
Other Archive Indexes
In addition to the archive file index, STOWAWAY also
maintains indexes about each archive volume and archive
group defined. The archive volume contains information
about each volume and its status in the archives. The group
index keeps all group names defined to Stowaway and their
associated descriptions.
24
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
STOWAWAY reference
Prepare your set of archive volumes
Before using STOWAWAY you will need to prepare a set of
archive volumes. When using diskettes as archive volumes
start with a fresh box of the highest quality diskettes you
can find. Of course, STOWAWAY can't tell the quality of
your disks; but, if your archives are important to you, it
is worth a few more cents per disk to avoid the problems and
wasted time poor disks can cost you.
Take the labels provided with the disk and a large felt
marker. Number the disks sequentially 1 through 10 (or
whatever). If you plan on keeping multiple archive disk
sets (not necessary), you can mark all the disks in a set
with a set identifier.
5┌───────┐
4┌┴──────┐│ Number your archive disks
3┌┴──────┐││ sequentially starting at
2┌┴──────┐│││ 1. There are no maximum
1┌┴──────┐││├┘ number of volumes.
│ ││├┘
│ O │├┘
│ | ├┘
└───────┘
If you are wondering about different Archive Disk Sets.
STOWAWAY can keep separate indexes for different sets of
archive disks. STOWAWAY can only examine or work with a
single archive set at any time. A good use for different
archive sets is when multiple users access the same machine.
Each user can have their own set of archive disks. It is
also nice to use a different set of archive disks for
testing STOWAWAY or demonstrating the system to others. For
most implementations only one set of disks are used.
25
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
STOWAWAY's Main Menus
Following are examples of STOWAWAY's main menu structure.
The (...) indicate where a menu selection takes you to
another sub-menu. All other selections immediately take the
action specified.
The capitalized character on each menu line indicates the
menu selection character that can be used to immediately
select a menu item. You may use a mouse with a single click
to select a menu option, or use the cursor up and down keys
to position a menu selection bar and then press <Enter> to
select any menu item.
┌──────────Main Menu──────────┐
│ Archive files to diskette │
│ Restore files from diskette │
│ Set up │
│ Utilities │
│ Help │
│ Print order form │
│ Exit │
└─────────────────────────────┘
┌─────────Archive────────────┐
│ Select files manually │
│ Scan files automatically │
│ Quit to main menu │
└────────────────────────────┘
┌─────────────Utilities────────────┐
│ Remove files after archival │
│ Delete files from archives │
│ Verify archived files │
│ Pack the archive index │
│ Build index from archive volume │
│ Clean archive indexes │
│ Set alternate display colors │
│ Quit to Main │
└──────────────────────────────────┘
26
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
ARCHIVE PROCESSING WITH MANUAL SELECTION
Manual archive selection lets you examine directory contents
of your hard disk space and individually select files for
archival. STOWAWAY provides scrollable directory displays
to assist you in examining files in each directory. Text
files and WordPerfect files can be viewed to determine their
contents. This can help you decide if the file should be
archived. The sequence of the directory list can be changed
to help you locate files by age, size, name or extension.
Depending on Setup options specified, you may also enter a
description for each file to be archived. This description
is stored in the archive index and can be used to locate
files to be restored.
Start manual archive processing by selecting <A> from the
Main Menu and <S> from the Archive sub-menu.
Entering archive file descriptions
┌─────────────────────────────────────────────┐
│ Do you want to enter descriptions for the │
│ Files to be archived? (Y/N) │
└─────────────────────────────────────────────┘
Stowaway asks this question when setup options indicate
descriptions are to be entered for archived files. If you
want to take the time to enter descriptions for each file
selected for archival, answer YES to this question. You
will be prompted for a description each time you mark a file
for archival. If you mark an entire directory for archival,
you will be asked for a description for each file in the
directory.
Request window for file description
┌──────────────────────────────────────────────────────┐
│ │
│ Enter description for C:\WP\REQUEST.LTR │
│ │
│ ______________________________________________ │
│ │
└──────────<Enter> accepts, <Esc> cancels─────────────┘
Even though you are asked to enter a description for every
file, you can press the <Enter> key without entering
descriptive text to indicate no description is to be
maintained for the file.
27
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
To stop the prompting for descriptions, press the <Escape>
key without entering any description data. You will not be
prompted again.
The Archive File Selection Display
Manual archiving involves browsing file names on your hard
disk and marking specific ones to be archived. Following is
an example of a the file selection display.
┌──────────────C:\WP─────────────────────────────┐
│ <PARENT> 26APR91 10:32p <DIR> │
│ <ROOT> 26APR91 10:32p <DIR> │
│ AGENDAS 5MAY91 4:10p <DIR> │
│ ARNOLD.LTR 10MAY91 8:15a 20430 │
│ BACKDAY.NOT 21JUN91 12:15p 3021 │
│ MONEY.GOT 19JUL91 7:32a 50583 │
└───────────────F10 accepts, ESC exits───────────┘
The file selection display shows files for one directory at
a time. Lines for the current and root directory are always
sorted to the top of the list along with other
subdirectories defined in the listed directory.
The top border of the display indicates the drive and name
of the directory being displayed. The bottom border gives
brief help about keys used to terminate the selection
process. The right hand border of the display holds a scroll
bar for mouse control of the list (not shown above). Also
not shown is a highlighted selection bar that covers one
entry at a time in the list. The selection bar's location
is modified by using the UP, DOWN, LEFT, and RIGHT cursor
control keys.
28
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
As files are selected, a status window in the upper right
portion of the display shows the number of files selected as
well as the amount of space to be archived. This helps you
to know when you have archived enough data to free up a
desired amount of hard disk space. An example of the status
window follows:
╔═════════════════════╗
║ Drive Statistics ║
║Total: 119,332,864 ║
║Used: 104,034,304 ║
║ Projected freespace ║
║ 15,198,560 ║
║ Space tagged ║
║ 100,000 ║
║ Files tagged: ║
║ 5 ║
╚═════════════════════╝
The Drive Statistics window Total field shows space
available on your hard drive. The Used value indicates the
amount of hard disk space currently in use. The Free space
value indicates the amount of hard disk space currently
available for use.
The Projected freespace field indicates the amount of space
that will be available on your hard disk after archive
processing is complete. This field is incremented as files
are tagged for archival. The Space Tagged and Files Tagged
fields are also incremented to show how much data you have
marked for archival.
Selecting Groups of Files for Archival
If you plan to assign group names to files to be archived,
you should select and archive different categories of files
during each archive process. Group names are assigned to
all files selected for an archive process. The group name
is selected after all files have been marked.
Group names are categories for keeping track of archive
files. See the information about group names documented
later in this manual for a complete explanation of archive
groups.
29
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
Archive File Selection keyboard usage
Following are defined the keys and their respective
functions in the file selection display:
<Space Bar> When positioned on a file name it either
marks the file to be archived, or if the
file has already been marked, unmarks
it. Filenames become highlighted in the
list when they are selected for
archival. A small checkmark symbol is
also displayed next to the filename to
indicate it is selected.
<Right Arrow> Marks the file highlighted by the
selection bar for archival. If the file
is already marked for archival, it will
remain marked. The file selection bar
is also moved to the next filename in
the list.
<Left Arrow> Unmarks the file highlighted by the
selection bar. If the file is not
marked for archival it will remain
unmarked. The file selection bar is
also moved to the next filename in the
list.
<Enter> Is used to position the list to a
different directory. Place the
highlight bar on any directory name and
press the <Enter> key to change to the
directory.
STOWAWAY remembers all files marked for
archival so you may mark files from
several directories before starting
archive.
Special filenames of <PARENT> and <ROOT>
are shown for any subdirectory listed.
You may press <Enter> on the <PARENT>
entry to list the files in the directory
above the current directory listed.
Pressing <Enter> on the <ROOT> entry
lists the root directory of the
currently selected drive.
30
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
<F1> As in all locations of STOWAWAY, press
the <F1> key for help on the current
activity.
<F3> Press <F3> to bring up a temporary
window to enter a DOS command or to exit
to DOS. You may temporarily exit to DOS
and return to archive processing when
ready.
<F4> Press <F4> to bring up a window to let
you change the hard disk drive you want
to archive files from.
<F10> The <F10> key signals the end of file
selection processing and starts the
archive process.
<Esc> Use the <Escape> key to terminate the
manual file selection process and return
to the STOWAWAY main menu. All selected
filenames will be released.
<S> Press the <S> key to activate a
selection window to specify an alternate
sort sequence for the file list.
╔══════════════════════╗
║ Change List Order ║
║ Sort Date Descending ║
║ Sort Name Ascending ║
║ Sort Size Descending ║
╚══════════════════════╝
Sorting by date lets you quickly find
the old files that are good candidates
for archival.
Sorting by size lets you quickly
identify the largest files that will
free more disk space when archived.
<V> Press the <V> key to View text or
WordPerfect files. The file viewer can
examine up to 500 lines of a file. Use
the viewer to confirm the contents of a
file before deciding to archive it.
31
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
Use the cursor control keys to control
the viewing of a file and press <Escape>
from the viewer to return to the file
list.
Selecting a directory structure to be archived
You may position the file selection bar over any
subdirectory name and press the <Right Arrow> or <Space
Bar> to mark it to be archived. STOWAWAY will
immediately present the following question
╔════════════════════════════════════════════════════════╗
║ C:\DIR is marked. Process all files within it? (Y/N) ║
╚════════════════════════════════════════════════════════╝
This is a reminder that you will mark the entire
directory for archival as well as all directories below
it. Press <Y> to continue to mark the directory.
Press <N> to cancel the mark directory request and
return to the selection list.
If you mark a directory for processing and are also
entering file descriptions for each file to be
archived, you will be prompted to enter a description
for each file in the directory.
Completing file selection
Once you have selected one or more files for archival, press
the <F10> key to exit the file selection display and proceed
to start the archive process.
32
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
ARCHIVE PROCESSING WITH AUTOMATIC SCANNING
Sometimes you know exactly what files you want to archive
and do not want to manually select each file individually.
The Automatic Scanning archive process lets you enter a set
of archive specifications and then start archive. Files
will be selected that meet your archive criteria. When you
select Scan Automatic from the STOWAWAY menus the following
form will be presented for you to complete:
Automatic File Selection
┌───────────────────────────────────────────────────────┐
│ │
│ Path to archive: C:\WP__________________________ │
│ │
│ Pattern to archive: *.*__________________________ │
│ │
│ Files older than: 1JAN89 │
│ │
│ Archive until this amount of freespace met: 2000K │
│ │
│ Select only files needing backup?: N │
│ │
│ Reset ARCHIVE attribute after ARCHIVE?: N │
│ │
│ Enter text │
└────────────────Press <F10> to begin───────────────────┘
Complete the automatic archive specification form as
follows:
Path to archive:
Enter a directory name files are to be archived
from. If this is a parent directory to other
directories, files may be archived from this
directory and all its subordinate directories.
Pattern to archive:
Enter a file pattern to be archived. *.* will
select all files from the selected directories.
You may specify normal DOS wildcard characters or
extended wildcard specifications like *TIM*.*.
This would select all files having TIM as any part
of the filename. An extended wildcard
specification of *T*I*M*.* indicates to select all
files having the three characters T,I,M in the
filename in the specified sequence.
33
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
Files Older than:
Often you want to archive old files and leave
newer ones on your hard disk. Specify an age to
indicate to only archive files older than the
specified age. You may enter age information in
the following formats:
1) Number of days old. Enter a number of
days. This number of days will be
subtracted from the current date. Any
files older than this date will be
considered candidates for archival.
2) Gregorian Date formats - The following
US date formats are supported.
31JAN91
01/31/91
01-31-91
Archive until this amount of freespace met:
You may optionally enter the amount of freespace
you ultimately desire on your hard disk. Archive
file selection will automatically attempt to
archive enough files to satisfy the desired
freespace and then stop. This will help you keep
as many files as possible on your hard disk and
still have the desired hard disk freespace.
The value can be entered as a total number of
characters, or in 1000's of characters (K), or in
1,000,000's of characters (M). The following
three examples all indicate to archive until two
million characters of freespace are available on a
hard disk.
2000000 2000K 2M
Select only files needing backup?
Each DOS file has an attribute in its directory
entry indicating it has been changed since it was
last backed up. Backup programs reset this
indicator after backing up the file so it will not
be processed during the next incremental backup
process. If you want to archive files that have
changed since their last backup, enter <Y> for
this value.
34
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
Reset ARCHIVE attribute after archival?
If you want STOWAWAY to reset the backup indicator
in a file's directory entry after archival specify
<Y>. for this value. The next archive process
based on the backup indicator will skip this file
assuming it was archived but not deleted from the
hard disk.
After completing the form presented on the display, press
<F10> to begin the archival process. STOWAWAY will scan the
desired directories to select files for archival. If you
want to terminate archive processing before starting archive
press <Escape> to return to STOWAWAY's main menu.
SPECIFYING ARCHIVE GROUPS
Archive groups...
After selecting one or more files to be archived, you
may assign a group name to the set of files. This group
name lets you categorize files in the archives. When
looking for files to restore, you may search by group
as well as filename or directory name. This
significantly reduces the effort required to locate
files.
There is no limit to the number of groups you may
define. New groups may be created at any time. When
STOWAWAY prompts you for a group name, you are
presented with a scrollable list of existing groups to
select from. You may select any previously defined
group or add a new one.
Sample of the group selection display.
┌────────────────Select a group─────────────────────┐
│ DOS_UTILITIES Obsolete DOS 3.x utilities │
│ DOS_SHAREWARE Old shareware not used │
│ DOS_SHELLS OLD AUTOMENU and Others │
│ WP_LETTERS Old correspondence │
│ WP_MEMOS 1984-1989 memos │
│ HOME_FINANCE Old tax programs │
│ HOME_GAMES Old monochrome games │
└───────────────Enter accepts, Esc exits────────────┘
35
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
Assume the above display has one entry highlighted with
a scroll selection bar. To select a group to be
associated with the archive set, use the UP and DOWN
arrow keys to position the scroll bar on any desired
group and press <Enter>.
Adding an archive group.
New groups may be defined when examining the group name
selection list. To define a new group, press <A> for
Add. A pop-up form will appear asking for the name of
the group to be defined, and a description to be
related with the group. After entering the group
information press <F10> to accept the new group
definition. Press <Escape> to cancel the group
definition request. You may delete a group at any time
by pressing <D> for delete.
Group names may contain any alphanumeric characters.
Groups are sorted by name when listed so, selecting a
good scheme for naming groups will let them be
displayed in a manner where they can be quickly
identified and selected. Consider a scheme like the
following:
DOS_UTILITIES
DOS_SHAREWARE
DOS_SHELLS
WP_LETTERS
WP_MEMOS
HOME_FINANCE
HOME_GAMES
The group description is simply a long description for
the group. Press <F10> to accept the group. Press
<Escape> to cancel.
36
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
Archive Processing
When all file and group selection processing is complete,
archive processing starts. First you are presented with an
Archive Status display similar to the following example:
Archive Status Display
╔═══════════════════════════════════════════════════════════════════╗
║ ╔═══════════╗ S T O W A W A Y ║
║ ║ ░░ 100% ║ Copyright 1991 by Patri-Soft ║
║ ║ ░░ ║ Archive processing ║
║ ║ ░░ ║ ║
║ ║ ░░ ║ ║
║ ║ ░░ ║ ║
║ ║ ░░ ║ Total Completed Remaining ║
║ ║ ░░ ║ Files: 2 0 2 ║
║ ║ ░░ ║ Characters: 13,184 0 13,184 ║
║ ║ ░░ ║ ║
║ ║ ░░ ║ ║
║ ║ ░░ ║ Path: D:\ASP\ ║
║ ║ ░░ ║ Filename: COPYRT.TXT ║
║ ║ ░░ ║ Size: 6,528 ║
║ ║ ░░ ║ Date/Time: 20JUN90 / 4:26a ║
║ ║ ░░ ║ ║
║ ║ ░░ ║ Disk statistics for drive A: ║
║ ║ ░░ ║ Volume 1 ║
║ ║ ░░ ║ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
║ ║ ░░ 0% ║ ║
║ ╚═══════════╝ Total bytes: ║
║ Bytes used: ║
║ Percent Complete Bytes free: ║
╚═══════════════════════════════════════════════════════════════════╝
The archive status display keeps you informed of the progress of
archival. It has the following basic contents:
Status Bar
The status bar at the left side of the display gives a
graphic status of the completion of STOWAWAY.
Totals
The totals lines show the number of files and total
characters to be processed, completed, and remaining to
be processed.
37
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
Current File
Shows information about the file currently being copied
to diskette.
Disk Statistics
The disk stats shown in the lower right portion of the
display show how much space is used on the output
archive volume and how much space is left. This is
useful to help you to know if you are soon to need
another archive diskette. For large archive jobs you
might want to wait to insert a new volume before going
for that short break.
Request for archive volumes
Immediately upon starting archive you will be asked to
insert a new archive volume in the drive. A message similar
to the following will be shown:
╔═════════════════════════════════════════════════════╗
║ Insert archive disk 1 into drive A. ║
║ ║
║ Press Enter when ready, or ESC for other options ║
║ ║
║ Waiting ║
╚═════════════════════════════════════════════════════╝
STOWAWAY has searched its volume indexes and found volume
one to be the next archive volume to use. Place volume #1
in the drive and press <Enter> to start the archive
processing.
38
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
If you press <Escape> to the volume request message you will
be presented with new options you may take. Following is an
example:
┌──────────────[ Waiting for disk #1 ]───────────────┐
│ │
│ Select desired action: │
│ (You may safely quit at this point) │
│ │
│ ┌────┐ ┌────────┐ ┌──────────────┐ │
│ │Quit│ │Continue│ │Start new disk│ │
│ └────┘ └────────┘ └──────────────┘ │
└─────────────────────────────────────────────────────┘
STOWAWAY indicates if you may safely quit processing at this
time. In some cases where a new volume is requested to hold
the second part of a file that will span multiple volumes,
STOWAWAY will indicate you may not quit processing without
having to restart archive for the file being processed.
You may select Continue by pressing <C> and you will be
returned to the display requesting the volume to be placed
in the drive.
If you are starting STOWAWAY and it is requesting a volume
from a previous archive process, you may press <S> to start
another new disk instead of appending the new archive data
to the last used volume. This is useful if you do not have
access to the previous archive volume. You might have
stored the used disks of your archive set in another
location or loaned them to someone.
Recovering from disk write errors
If DOS should encounter an disk write I/O error when writing
to the archive volume, you will be presented with messages
and options to take in continuing from the error. This only
applies if the DOS VERIFY flag (see setup) is set on.
┌──────────────────────────────────────────────────────────────┐
│ A disk I/O error has occurred during archive processing. │
│ The file currently being processed may not have been │
│ safely archived. Indicate how to continue: │
│┌────┐┌─────────────────┐┌─────────┐┌────────────────────────┐│
││Quit││Continue Normally││Try again││Force new disk/try again││
│└────┘└─────────────────┘└─────────┘└────────────────────────┘│
└───────────────────── <Enter> accepts ────────────────────────┘
39
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
This message is presented after DOS issues its message to
RETRY, FAIL, or ABORT after a disk I/O error. If you
selected RETRY and processing continued successfully, the
file was archived successfully. If you selected FAIL or
IGNORE, the file was not archived correctly. Select one of
the following responses to indicate how to proceed after the
I/O error:
Quit
Stop archiving immediately.
Continue Normally
The retry was successful and you want to continue
archiving. If the error was caused by faulty disk
media, you may want to Try again, or Try a new
disk to move the data for the file off the
questionable disk area.
Try again
Archive the file again on a new area of the same
archive disk. This will skip over faulty area of
a disk. We recommend using Force New disk and try
again over this option since it is better not to
try and archive any more data on a potentially
faulty volume.
Force new disk and try again
(Recommended)
Stop writing to the current disk. Ask for a new
disk and start archiving for the same file again.
The file will be written to the new disk and
archive processing will continue.
Completing archive
Before archive completes you will see the following message
presented on the display. This message is for your
information only. You do not need to take any action.
STOWAWAY is letting you know it is backing up its archive
indexes to the output archive volume.
┌─────────────────────────────────────────────────────┐
│ │
│ Saving Archive index backup to disk. Please wait... │
│ │
└─────────────────────────────────────────────────────┘
40
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
Once archival completes the following message will be
presented on the display. This is to give you a chance to
examine archive statistics before leaving the archive status
display. Press enter to indicate you are ready to
continue..
The last message shown by archive relates to your archive
volume. Since STOWAWAY has saved its indexes on the last
volume it used, you should always keep track of this volume.
Remove the archive volume from the drive and file it so you
know it was the last disk used. Turn it sideways, upside-
down, backwards, or just place it in front of all other
volumes.
┌───────────────────────────────────────────────────────┐
│ │
│ │
│ Archiving complete. Remove volume from the drive and │
│ store so you may relocate it if needed for recovery. │
│ │
│ Press <Enter> to continue... │
│ │
└───────────────────<Enter> to continue ────────────────┘
Once STOWAWAY has returned you back to its main menu you may
start another archive or end STOWAWAY to return back to your
operating system.
41
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
Restore
Restore is the process of copying a file from archive media back
to normal disk storage. Restore is a copy, not a move. The
archive copy remains intact exactly as before the restore. You
may delete the restored copy and still have access to the data
through the archives.
Restore brings a file back to online storage from the "archives".
Often we refer to the archives as "offline" storage. STOWAWAY's
job is to make locating and restoring files easy. Several
features are included to help you organize the archives and
locate files in them.
Archive data is stored in a special compressed form on
consecutive disks of offline storage. The special compressed
format obviously saves diskette space but also increases archive
performance. STOWAWAY is needed to restore any file archived by
it.
STOWAWAY indexes all archived files in a set of hard disk
indexes. When you request to search for a restored file, the
index is searched to locate information about the file to be
restored.
STOWAWAY gets a disk location and a disk number from the index
and asks you to place the disk in the drive. It then reads the
data and writes it back to your hard disk.
Since the archives potentially contains 1000's of files restore
processing provides facilities to easily locate and restore
exactly the files you need. Restore begins by asking for
specifications for files to be restored. There are three levels
of file selection:
1. First you may optionally enter filename, pathname, and
other information.
2. You may optionally specify a group name files are to be
restored from. This will help you isolate selection of
a category of files in the archives.
3. Files qualifying the first two specifications may be
displayed in a scrollable list for your examination and
manual selection.
Once files are selected, restore processing begins.
42
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
Entering Restore Selection Specifications (level 1 qualification)
Upon selecting the Restore option from STOWAWAY's main menu you
will be presented with the following display which asks for the
first level of file selection criteria. You may skip this
selection level by pressing <F10>. STOWAWAY will assume all
files qualify this selection level.
Restore File Selection (level 1)
┌───────────────────────────────────────────────────────────────┐
│ │
│ Drive to restore : * │
│ │
│ Path to restore : * │
│ │
│ Pattern to restore : *.* │
│ │
│ Restore TO directory: │
│ │
│ Description containing text: _______________________________ │
│ │
│ │
│ Select files archived AFTER this date : │
│ │
│ Select files archive BEFORE this date: │
│ │
│ Enter text │
└─────────────────── Press F10 to begin or ESC to abort ────────┘
Level 1 selection criteria specification
Drive to restore : *
Enter a drive letter indicating the drive files
were originally archived from. '*' indicates to
select files no matter what drive they were
archived from.
Path to restore : *
Enter a pathname where files were archived from.
'*' indicates to select files no matter what
directory they are archived from. A directory
specification may end with '*' to indicate the
files are to be selected from any directory name
43
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
beginning with the name specified up to the *.
Valid specifications are:
\
\WP
\WP*
\WP\LETTERS
\WP\LETTERS\
Pattern to restore : *.*
Enter a complete filename or wildcard pattern name
to indicate the names of archive files selected.
Extended wildcard capabilities allow you to enter
multiple * in a name specification. The *
indicates any number of characters may exist in
this portion of the name. Valid specifications
are:
AUTOEXEC.BAT
AUTO*.BAT
AUTO*.*
*.*
*TOEX*.BAT
*U*O*X*.BAT
Restore TO directory:
Optionally enter a target pathname where files are
to be restored. This is a full pathname including
drive letter. If no directory is specified the
files will be restored to their original
directories and drive. Valid specifications are:
C:\WP
\WP
C:\WP\LETTERS\
Select files where description contains:
If you have entered descriptive text for files
archived, you may select files based on the
contents of descriptive text. Enter any word or
phrase to be found in descriptive text. Only
files containing this text will be selected for
subsequent restore or listing on the scrollable
44
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
selection list. The text will be searched with
upper/lower case ignored.
Select files archived AFTER this date :
Optionally enter a date to indicate to only
restore files last created or updated since this
date. Others will be rejected.
Select files archived BEFORE this date:
Optionally enter a date to indicate to only
restore files last created or updated prior to
this date. Others will be rejected.
Selecting a Group to Restore (level 2 qualification)
If you would like to further qualify your file selection by
selecting only files archived under a group name, scroll
through the group list and chose a group. Following is a
example of a group selection display.
Sample of the group selection display.
┌────────────────────Select a group──────────────────────┐
│ (All groups) Restore all files in all groups │
│ DOS_UTILITIES Obsolete DOS 3.x utilities │
│ DOS_SHAREWARE Old shareware not used │
│ DOS_SHELLS OLD AUTOMENU and others │
│ WP_LETTERS Old correspondence │
│ WP_MEMOS 1984-1989 memos │
│ HOME_FINANCE Old tax programs │
│ HOME_GAMES Old monochrome games │
└───────────── <Enter> accepts, Esc exits ───────────────┘
Assume the above display has one entry highlighted with a
scroll selection bar. To select a group to restore files
from, use the UP and DOWN arrow keys to position the scroll
bar on any desired group and press <Enter>. To ignore
groups and select files from all groups, select the top menu
(all groups) and press enter.
Listing Files Selected for Restore (level 3 qualification)
45
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
The third level of restore file selection is manual
selection of exact files to be restored. Manual selection
is an optional step. The following display is presented as
the last step prior to starting the restore process
┌───────────────────────────────────────────────────────────┐
│ │
│ Do you want to List the files for manual selection, or │
│ Restore them immediately? │
│ │
│ ┌────┐ ┌───────┐ │
│ │List│ │Restore│ │
│ └────┘ └───────┘ │
└─────────────── <Enter> accepts, Esc exits ────────────────┘
If you have already specified sufficient criteria to select
all files to be restored, press <R> to restore all selected
files. If you would like to list all files matching the
selection criteria entered, press <L>. You will be
presented with a scrollable selection list of files.
Restore File Select List Processing
STOWAWAY lets you optionally examine and select files
matching previously entered restore criteria. This
scrollable selection list provides extensive information
about files maintained in STOWAWAY's archives. Due to the
amount of data stored about each file, STOWAWAY provides
three different views of this list. Each view shows a
different category of information about archived files.
View #1 View #2 View #3
Filename Filename Filename
DOS File Date Archive Date File Description
DOS File Time Archive Time
Original file Size Archive Size
Original Pathname Expiration date
Compression Percent
Archive Volume ID.
When the scrollable selection list is first displayed VIEW #1 is
shown. To change between the three different views, press the
<F6> key. As <F6> is repeatedly pressed the next view is shown.
VIEW #1 is shown again after VIEW #3.
46
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
The following keys are active when the restore selection list is
displayed:
<Space Bar> Toggles selection - marks unmarked files to
be selected for restore. Unmarks marked
files to remove them from being selected.
<Right Arrow> Marks file to be selected for restore.
Advances the file selection bar to the next
file. Holding down the key will mark a
series of files.
<Left Arrow> Unmarks file selected for restore. Advances
the file selection bar to the next file.
Holding down the key will unmark a series of
files.
<F1> Help
<F2> Zoom. When first displayed the scrollable
list is shown in reduced size to make room
for help text at the bottom of the display.
Press <F2> to zoom the screen larger. The
help text at the bottom of the screen will
disappear.
<F3> Enter a DOS Command
<F5> Locate text. If you have entered descriptive
text for archived files you may search for
words or phrases in the text. Press <F5> to
request a window to enter the text to be
found. STOWAWAY will search all displayed
files for the entered text. Only files
containing the text will be displayed.
<F6> Show next VIEW. Toggles between the three
different views of the archive file list.
<F10> Start restore. After you have marked one or
more files to be restored, press <F10> to
accept the selected items and start restore.
<Escape> Exit file selection list and quit restore
processing.
<S> Sort the list. Press <S> to display a
selection menu of alternate sort sequences
47
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
for the restore selection list. Following is
an example.
┌─Change Sort order──┐
│ Name order │
│ Directory order │
│ daTe order │
│ Archive date order │
└────────────────────┘
Name order Sorts by filename
Directory order Sort by filename within
directory name where it
was archived from.
daTe order Sort by the date the file
was last updated or
created (before it was
archived).
Archive date order Sort files in sequence by
the date they were
archived.
Following are examples of the three different views of the
archive file selection list. Select one or more files to be
restored or press <Escape> to return to STOWAWAY's main menu.
After selecting the desired files, press <F10> to start restoring
the files.
VIEW #1
┌────Name──────────Date──────Time──────Size───────Path───────┐
│ AUTO.BAT 15JUN91 2:26p 134 C:\BAT\ │
│ B.BAT 15JUN91 2:39p 64 C:\BAT\ │
│ BC.BAT 7SEP91 2:39p 83 C:\BAT\ │
│ BCX.BAT 19MAY91 6:30p 144 C:\BAT\ │
│ BITFAX.BAT 27MAR91 4:01p 29 C:\BAT\ │
│ C.BAT 19AUG90 7:29p 99 C:\BAT\ │
│ C2.BAT 9MAR91 7:54a 56 C:\BAT\ │
│ DELA.BAT 20DEC90 7:48a 16 C:\BAT\ │
│ DELB.BAT 19JUL91 6:22a 23 C:\BAT\ │
│ DIRA.BAT 19NOV86 2:23p 11 C:\BAT\ │
│ DIRB.BAT 25APR91 6:59a 8 C:\BAT\ │
└────────────────── F10 accepts, ESC exits ──────────────────┘
48
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
VIEW #2
┌──Name───────ArcDate───ArcTime───ArcSize──Edate─Ratio───Disk┐
│ AUTO.BAT 8OCT91 10:17a 134 10OCT92 1.00% 1 │
│ B.BAT 8OCT91 10:17a 64 1.00% 1 │
│ BC.BAT 8OCT91 10:17a 83 11NOV93 1.00% 1 │
│ BCX.BAT 8OCT91 10:17a 144 1.00% 1 │
│ BITFAX.BAT 8OCT91 10:17a 29 1.00% 1 │
│ C.BAT 8OCT91 10:17a 99 1.00% 1 │
│ C2.BAT 8OCT91 10:17a 56 1.00% 1 │
│ DELA.BAT 8OCT91 10:17a 16 1.00% 1 │
│ DELB.BAT 8OCT91 10:17a 23 1.00% 1 │
│ DIRA.BAT 8OCT91 10:17a 11 1.00% 1 │
│ DIRB.BAT 8OCT91 10:17a 8 1.00% 1 │
└─────────────────── F10 accepts, ESC exits──────────────────┘
VIEW #3
┌────Name───────────Description──────────────────────────────┐
│ AUTO.BAT │
│ B.BAT │
│ BC.BAT │
│ BCX.BAT │
│ BITFAX.BAT Start the bitfax software │
│ C.BAT │
│ C2.BAT │
│ DELA.BAT Delete the files from drive A: │
│ DELB.BAT │
│ DIRA.BAT │
│ DIRB.BAT Directory on drive B: │
└────────────────── F10 accepts, ESC exits───────────────────┘
49
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
Starting Restore
After starting restore STOWAWAY will determine the volumes needed
to restore the files and immediately request you place the
correct volume in the input drive. Following is an example of
the volume mount message STOWAWAY will issue.
╔═══════════════════════════════════════════════════════╗
║ Insert archive disk 1 into drive A. ║
║ ║
║ Press Enter when ready, or ESC for other options ║
║ ║
║ Waiting ║
╚═══════════════════════════════════════════════════════╝
Locate the requested volume in your set of archive volumes and
place it in the indicated drive. You may terminate restore at
any time by pressing <Escape> when STOWAWAY is requesting an
input volume. All files restored to this point of processing are
restored correctly. Other files selected will need to be
selected again in a subsequent restore process to be restored.
50
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
Restore Processing
The restore display is presented throughout the restore process.
It provides status of the restore.
Restore Status Display
╔═══════════════════════════════════════════════════════════════╗
║ ╔═══════════╗ S T O W A W A Y ║
║ ║ ░░ 100% ║ Copyright 1991 by Patri-Soft ║
║ ║ ░░ ║ Restore processing ║
║ ║ ░░ ║ ║
║ ║ ░░ ║ Total Completed Remaining ║
║ ║ ░░ ║ Files: 3 ║
║ ║ ░░ ║ Characters: 219 ║
║ ║ ░░ ║ ║
║ ║ ░░ ║ Path: C:\BAT\ ║
║ ║ ░░ ║ Filename: B.BAT ║
║ ║ ░░ ║ Size: 64 ║
║ ║ ░░ ║ Date/Time: 15JUN91 / 2:39p ║
║ ║ ░░ ║ ║
║ ║ ░░ ║ Disk statistics for drive C: ║
║ ║ ░░ ║ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
║ ║ ░░ ║ 0% freespace 100% ║
║ ║ ░░ 0% ║ ║
║ ╚═══════════╝ Total characters: ║
║ Characters used: ║
║ Percent Complete Characters free: ║
╚═══════════════════════════════════════════════════════════════╝
The restore status display keeps you informed of the progress of
restoring files. It has the following basic contents:
Status Bar
The status bar at the left side of the display gives a
graphic status of the completion of STOWAWAY.
Totals
The totals lines show the number of files and total
characters to be processed, completed, and remaining to
be processed.
51
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
Current File
Shows information about the file currently being
restored.
Disk Statistics
The disk stats shown in the lower right portion of the
display show how much space is used on the target hard
disk and how much freespace remains.
Overlaying Files with duplicate Names
If STOWAWAY finds a file with the same name already exists
in the target directory it may overwrite the file with the
archive version, bypass restoring the file, or compare the
dates and times of the two files and restore the file only
if it is a more recent copy than the version on disk.
STOWAWAY Setup options let you specify any of these
alternatives as an action to automatically be taken during
restore. A special setup option of "Ask" indicates restore
processing is to ask what action to take each time a
duplicate file name is found. In this case the following
question is asked.
┌────────────────────────────────────────────────────────┐
│ │
│ File B.BAT already exists. Ok to replace? │
│ │
│┌───┐┌──┐┌──────┐┌─────────────────┐┌──────────────────┐│
││Yes││No││Update││Continuous update││continuous Replace││
│└───┘└──┘└──────┘└─────────────────┘└──────────────────┘│
└───────────── <Enter> accepts, Esc exits ───────────────┘
Press Y, N, U, C, or R to indicate the action to take.
<Escape> immediately terminates restore. Following are
explanations of possible responses:
<Yes> Replace the file immediately.
The archive file will overlay
the already existing file.
<No> Do not restore the file.
Leave the file on the hard
disk.
52
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
<Update> Restore the file if it is a
newer version than the file on
the target drive. If the
archive file is older than the
disk file, bypass restoring
this file.
<Continuous update> This is the same response as
<Update> with the additional
feature of indicating STOWAWAY
is not to ask this question
again if another duplicate
file name is found. A answer
of <Update> will be assumed
for all future instances of
this situation during this
restore process.
<continuous Replace> This is the same response as
<Replace> with the additional
feature of indicating STOWAWAY
is not to ask this question
again if another duplicate
file name is found. A answer
of <Replace> will be assumed
for all future instances of
this situation during this
restore process.
Completing Restore
After restore has completed restoring all files the
following message will be presented over the Restore Status
Display. It is an informational message to let you know the
last action taken by STOWAWAY. Press <Enter> to acknowledge
the message and return to STOWAWAY's main menu.
┌────────────────────────────┐
│ │
│ Restore Complete │
│ │
└─── <Enter> to continue ────┘
53
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
Utility Functions
The utility menu off STOWAWAY's main menu provides access to
functions supporting STOWAWAY archive and restore functions.
Select Utilities from the main menu to access the following
menu of options.
┌─────────────Utilities────────────┐
│ Remove files after archival │
│ Delete files from archives │
│ Verify archived files │
│ Pack the archive index │
│ Build index from archive volume │
│ Clean archive indexes │
│ Set alternate display colors │
│ Quit to Main │
└──────────────────────────────────┘
Utilities - Remove files after archival
STOWAWAY options let you archive files without deleting
files after archival is complete. When you use this feature
STOWAWAY maintains a list of all files archived. This list
may be used to delete the files from the original hard disk.
The purpose of this feature is to provide an optional
capability to let you archive data and verify archive disks
before deleting the original files.
Use this utility option to delete the last set of files
archived from your system. A message will appear indicating
files are being deleted. Once all files are deleted you
will be presented with a message indicating all files have
been successfully deleted.
Utilities - Delete files from archives
Archive data is not always permanent. Many file only have a
limited usefulness in the archives and then can be released.
A good example is old versions of program files. You may
want to keep old software versions until you are confident
the new versions work as desired. At some later time you
can unclutter the archives by deleting the software files
index entries. The Delete Archive File function will find
archive file index entries and remove them.
54
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
The Delete Archive File function works like the restore
process. You will be presented with a display asking for
specifications for files to be deleted. As in restore,
complete the form and press <F10> accept the specifications.
┌──────────────────────────────────────────────────────────┐
│ │
│ Drive to select: * │
│ │
│ Path to select: * │
│ │
│ Pattern to select: *.* │
│ │
│ Delete files archived BEFORE this date: │
│ │
│ Delete files archived AFTER this date : │
│ │
│ Enter text │
└─────────── Press F10 to begin or ESC to abort ───────────┘
STOWAWAY will search the archive indexes for all files
matching the selection criteria. You will be presented with
a selection list similar to the one presented during restore
processing. Select the specific files to be removed from
the archives. When done with specific file selection press
<F10>.
STOWAWAY will remove each index entry from the archives.
You will no longer be able to restore the files with
STOWAWAY. Archive index size will be reduced and future
archive index lists will not show these files.
NOTE - This process only logically removes the files from
the archive index. To actually release the space they
occupy in the archive index you must use the PACK ARCHIVE
INDEX utility provided,
Utilities - Verify archived files
Archival is a critical process where you often want to
confirm archival has correctly archived data. Sometimes you
may be unsure of the validity of your archives. This might
happen if you suspect faulty archive volumes were used, or a
drive might not be functioning properly. STOWAWAY provides
the archive verify function to read archive data and verify
it can be used to restore the files.
55
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
Volume verification is quick and easy as it only requires a
quick read of archive volume data. No data is actually
written to the hard disk.
Two verification processes actually happen. First, DOS
verifies all the data can be read from the archive disk.
Second, a CRC check verifies data is accurate by
arithmetically verifying the data in the archives is the
exactly the same as the data was on the original hard disk
before it was archived.
Archive verification may verify a part of the archives, or
an entire archive set. Upon selecting the verify function
you will be presented with a specification display similar
to restore processing. Indicate the qualifications of all
files to be verified.
┌──────────────────────────────────────────────────────────┐
│ │
│ Drive to verify : * │
│ │
│ Path to verify : * │
│ │
│ Pattern to verify : *.* │
│ │
│ Select files archived AFTER this date : │
│ │
│ Select files archive BEFORE this date: │
│ │
│ Enter text │
└───────────── Press F10 to begin or ESC to abort ─────────┘
The verification selection form is much like the restore
form. You are asked to fill in the following fields:
Drive to verify: Enter the drive letter where the
files were originally archived
from. (I.E. C, D)
Path to verify: Optionally enter the pathname where
the files were archived from. If
no path is specified files from all
paths will be selected. I.E.
\LETTERS \PICTURES
Pattern to verify: Enter a filename pattern to verify.
If none, all file patterns will be
selected.
56
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
Archived before/after: You may select a group of files
according to the date on which they
were archived. You may use one or
both of the date specifications.
Press <F10> to accept specifications and start verification.
<Esc> to quit.
Like restore, you will be asked to place each archive volume
in the input drive until all data is verified. You will be
notified with error message displays if any errors are found
in the data.
Utilities - Pack the archive index
STOWAWAY archive indexes periodically need reorganization to
recover space released by expired of deleted archive files.
Packing of the archive indexes performs two functions.
First, it examines optional expiration dates assigned to
each archived file and deletes expired files from the
archives. Second, it reorganizes the archive index to
recover space from deleted file index records.
Although the packing process will always attempt to release
space left by deleted file index records, you may optionally
decide if you want expired files released from the archives.
You may want to bypass releasing expired files if there is
no real need to release the space their index records
occupy. The biggest reason to remove expired data is to
unclutter the archives. If this is not a problem, you can
defer removing expired files in case their data is needed at
some later time.
Immediately after selecting the Pack option from the
utilities menu you will be presented with the following
question and options:
┌─────────────────────────────────────────────┐
│ │
│ Do you want to pack the archive index file? │
│ │
│ ┌───┐ ┌──┐ ┌─────────────┐ │
│ │Yes│ │No│ │Expired files│ │
│ └───┘ └──┘ └─────────────┘ │
└──────── <Enter> accepts, <Esc> exits ───────┘
57
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
Respond <Yes> to recover space released by deleted
archive index records. Expired archive index entries
will not be processed and will remain in the archives.
Respond <No> to cancel the request to pack the files
without taking any further action.
Respond <Expired files> to delete expired archive index
entries and to recover space released by deleted
archive index records.
Once your response is entered the following message will
appear indicating the index pack process is active.
┌─────────────────────────────────────────────────────┐
│ │
│ Now removing deleted records from archive index... │
│ │
└─────────────────────────────────────────────────────┘
Once index packing is complete you will be returned to
STOWAWAY main menus. You may then use other STOWAWAY
functions.
Utilities - Build index from archive volume
As STOWAWAY archives files, it saves information about each
file in a set of indexes on the hard disk. These indexes
allow you to quickly locate files when you want to restore
them.
Since the indexes are critical to the system, they are
backed up to the last archive disk at the end of each
archive process. This takes a little time and disk space
but ensures indexes are always backed up and are a part of
the archives.
Since the archive indexes are kept on archive volumes, each
archive set becomes a portable set of files you may take to
another computer for use.
To use any archive set, the archive indexes must exist on
your hard disk. If they are somehow lost or not available
on the computer where you want to restore files, you must
first restore the index from the backup copy on archive
volumes. The indexes are always found on the last one or
two volumes of the archive set. It is your responsibility
to keep track of these disks since STOWAWAY does not know
58
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
disk numbers without its indexes. During index recovery
STOWAWAY will ask you to place the last used archive volume
in the drive. It is always important to keep track of the
last archive volume you use. If you have lost track of the
last archive volume, use the DOS directory command to
display the files on each archive volume. The volume with
the most recent file dates is the last disk used.
STOWAWAY immediately asks for the last archive volume when
index restore is started. Place the volume in the drive and
press <Enter>. In some cases STOWAWAY may ask for a second
volume if it determines part of the indexes backed up are
split from a previous volume.
┌─────────────── Restoring Archive Indexes ───────────────┐
│ │
│ Attempting to restore indexes from archive diskettes. │
│ │
│ Place the last archive disk used in drive A: │
│ │
│ Press <Enter> when volume is ready, <Escape> to exit. │
│ │
└───────────────── <Enter> to continue ───────────────────┘
STOWAWAY will read the indexes and put them on the hard
drive. You will be notified when the indexes are properly
restored. Once complete you may then restore files or
archive more data into the archives.
Utilities - Clean archive indexes
This function of STOWAWAY deletes the current set of archive
indexes. It is a seldom used function. Its only basic
purpose is to delete test versions of archive index sets
before reusing them. Your primary set of indexes should
never be deleted as they are required for restoring data.
After an archive index set is deleted, you will no longer be
able to restore files from the archive set. You can use the
restore archive index function to replace the indexes on the
hard disk.
59
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
After selecting the index delete function you will be
prompted to verify you really do want to complete this
process:
┌──────────────────────────────────────────────────────────┐
│ │
│ Refreshing the indexes will erase all │
│ information about archived files. │
│ │
│ Are you sure you want to refresh the indexes? │
│ │
│ ┌───┐ ┌──┐ │
│ │Yes│ │No│ │
│ └───┘ └──┘ │
└───────────── <Enter> accepts, Esc exits ─────────────────┘
Respond <Yes> to continue the process and delete the
current archive index set.
Respond <No> to cancel the index deletion process and
return to STOWAWAY main menus.
Once the indexes have been deleted, you may create them
again by archiving more data with STOWAWAY.
Utilities - Set alternate display colors
STOWAWAY lets you change the colors of all its display
windows to any colors of your choice. Setting alternate
display colors involves setting NORMAL, REVERSE, HIGHLIGHT,
and BORDER colors for each different type of window.
First, you are presented with a menu of each window type
used by STOWAWAY. You may change colors on any or all
window types.
60
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
Window colors are stored permanently on disk in the options
file so they will be used each time you use STOWAWAY. When
you are finished setting colors, press <Exit> to return to
STOWAWAY's menus.
┌───────────────────── Select Colors─────────────────────┐
│ │
│ Menus │
│ Pop-Ups │
│ User input │
│ Archive/Restore/Main │
│ Copyright Message │
│ Registration Message │
│ Disk statistics │
│ disK mounts │
│ Thermometers │
│ deFault colors │
│ Help Colors │
│ Exit to main │
│ │
│ ╔════════════════════════════════════════════════════╗ │
│ ║ Change all Menu colors ║ │
│ ╚════════════════════════════════════════════════════╝ │
└─────────────── Press <Enter> to select ────────────────┘
You are presented with a screen with four major color types
to pick across the top and with a screen full of color
combinations below.
Use the <Space Bar> to move between each color type.
Pressing the space bar indicates the current color selection
for the active type is to be accepted.
Use the <Arrow Keys> to position the selection box on the
color combination to be used for the current color type.
When you are positioned on the desired color, press the
<Space Bar>.
Press <Enter> to accept all colors and return to the window
type menu. You can then change colors on another window
type.
Press <Escape> to return to the window selection menu and
leave the colors as they were originally defined.
61
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
Command Line operation
STOWAWAY is normally operated through its menu structure.
This provides a simple technique for archiving files that
reassures you at every step with displays and questions to
let you make decisions.
More experienced users may desire to use STOWAWAY command
line interface to archive files. When the command line
operation is used, STOWAWAY will take all its basic
instructions from the command line and start the archival
process. It will still require the proper disks be placed
in the drives and may ask for other decisions to be made
based on your options. Although not totally automated it
provides a quick start to archiving specific data.
A typical use of command line operation is to start STOWAWAY
to archive specific files. Following is a sample command to
archive all files in the directory named \TESTDIR\..
STOW \TESTDIR\*.*
The STOWAWAY command line format
STOW path /B /BA /D:01-01-91 /DEL /F:nnn /ID:xxx /ND /S
/RA /R
Command parameter explanations
path Specify pathname to be archived.
STOW C:\LETTERS\*.*
STOW \LETTERS
/B Select only files with the DOS ARCHIVE
(BACKUP) indicator set. If you want to use
STOWAWAY to limit its file selection to files
marked as needing backup.
/BA Batch file operation. This parameter
indicates STOWAWAY is to attempt to complete
processing without prompting the user.
ARCHIVE COMPLETE and other such messages will
not wait for a user response. STOWAWAY menus
will not be used. You still may be prompted
62
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
for volumes to be placed in drives and to
decide how to handel error or exception
conditions.
/D:xxx STOWAWAY is to limit its file selection to
files older than the specified date. Use to
free hard disk space by scanning a directory
and archiving "old" files. Dates can have
multiple formats. See information in the
archive section of this manual for more
information about different date formats.
/D:31DEC91
/D:01/01/91
/D:60 <== over 60 days old
/DEL If your STOWAWAY options are set to NOT
delete files after they have been archived,
this parameter will let you override that
specification and force STOWAWAY to delete
files after they have been successfully
archived.
/EV During restore, it is sometimes desirable to
only restore files in certain volumes. You
may specify a range of disk volumes by using
the /EV and /SV parameters. For example, to
restore the files after volume 6 and before
volume 9, the command line would be:
STOW /SV:6 /EV:9
/F:nnn Archive until nnn characters of hard disk
space available. Use this parameter to cause
STOWAWAY to stop archiving files when the
hard disk being processed has a specified
amount of free space available.
63
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
The freespace parameter has three different
forms (characters, K=1000's of characters,
M=1,000,000s of characters). Each of the
following examples will stop archiving when
1,000,000 characters of hard disk freespace
exist.
/F:1000000
/F:100K
/F:1M
/ID:xxx Alternative archive index set id. Specify
any three characters to archive to an
alternative index set. For more information
about alternate archive index sets, see the
heading about Archive Index Sets in the
manual. When not specified it is assumed the
value will be "STO".
/ID:TOM
/ND Normally options are set to delete files
after they have been archived. Use this
parameter to prevent the archived files from
being deleted.
/R You may also accomplish restore from the
command line. Specify a path as if you were
archiving, and append /R to the command line.
/RA After archiving files, if you want STOWAWAY
reset the Archive attribute, select this
option
/S If you already know the archive volume
STOWAWAY will use, you may place it in the
drive prior to starting STOWAWAY and specify
this parameter to have STOWAWAY assume the
volume is present. STOWAWAY will not ask you
to place it in the drive during archival.
This parameter is designed for those users
archiving to huge capacity disk devices where
volume mounting is not normally necessary.
/SV To start the restore process with a certain
diskette, use this command. For example, to
64
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
restore only files on disk 6 and above, use
the command:
STOW /SV:6
Specifying options through DOS environment variables
Any STOWAWAY command line parameters may be placed in DOS
environment variables to be effective each time STOWAWAY is
started. Use the DOS SET command to add the parameter to
the environment string. The environment variable name used
by STOWAWAY is STOW. The following example demonstrates the
most common use the environment variable for STOWAWAY. In
this example, the SET command is used to cause STOWAWAY to
use an alternate index set identifier of TOM each time it is
started.
SET STOW=/ID:TOM
See your DOS manual for more information about the SET
command. The SET command is often placed in the
AUTOEXEC.BAT file on a user's hard disk so it may
automatically be issued each time your system is started.
65
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
ARCHIVE MAINTENANCE
Multiple Archive sets
STOWAWAY lets you keep and use multiple archive sets on the
same computer system. Although not often necessary, this
feature is useful in many situations. Some examples are:
-- To use an archive set from one system to restore
data to another.
-- To create a special archive set apart from your
normal set to move files from one system to
another.
-- To create separate archive sets for multiple users
of a system.
-- To test your current archive set by restoring its
indexes to a different archive set identifier.
An archive set consists of hard disk archive indexes and all
archive volumes holding files referenced by those indexes.
Archive sets are given three character set identifiers.
This identifier is normally "STO" but may be altered when
starting STOWAWAY by using the /ID:xxx command parameter.
An alternate archive set identifier may also be established
by placing the /ID:xxx parameter in STOWAWAY's DOS
environment variable.
Archive set indexes consist of a set of three index files
and a STOWAWAY options file. These files exist on the hard
disk in STOWAWAY's directory. The normal files are named as
follows:
STOSAWAY.DAT
STOVOLIX.DAT
STOGRPIX.DAT
STOFILIX.DAT
Notice that each file name begins with the three characters
"STO". These identify this as the main archive set for
STOWAWAY. When you start STOWAWAY with an alternative
archive set identifier using the /ID:xxx parameter, a new
archive set is created with the names changed to begin with
the alternative set id.
66
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
Alternate archive indexes may be created new by starting
STOWAWAY with the /ID:xxx parameter and then archiving
files. They may also be created by starting STOWAWAY with
the /ID:xxx parameter and restoring archive indexes from
archive volumes. The indexes from the archive volume will
be assigned the archive set identifier used to start
STOWAWAY.
Alternate archive sets are identical in function and usage
to the normal index STOWAWAY uses. When using alternate
index identifiers, be careful to use the correct index set
for the files you are processing.
Backing up the indexes
The archive indexes are backed up to archive volumes after
each archive process. This insures the archive set is
always complete. Your system backup procedures may also
backup the archive indexes each time it processes. This
provides redundant backups of archive indexes. Each backup
is valid and useful when needing to recover archive indexes.
It is recommended to let your backup system continue to
backup the archive indexes as full hard disk recovery
procedures will be simplified. If you do not backup archive
indexes with your normal backup system and need to recover
your entire hard disk, you will also separately be required
to recover the archive indexes.
Making copies of archive data
Each archive volume in an archive set is in a normal DOS
format. Archive volumes may be copied using DOS DISKCOPY or
XCOPY commands.
For safety reasons you may want to take a copy of archive
information and store it at an offsite location. To do
this, use the DISKCOPY command to copy an archive volume to
another diskette. Store the original archive volume back
with the archive set, and take the copied volumes to your
offsite location.
When you only have a single drive to read and write a
specific disk format use the DOS DISKCOPY command as
follows. It will use memory to copy a volume to a new
volume. The drive letters for the source and new volumes
67
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
are the same. DOS will issue messages indicating what
volumes to place in the drives and when.
DISKCOPY A: A:
If you have multiple drives able to read and write the same
volume format, use the DISKCOPY command with different drive
letters. The first drive identifier is for the source
volume, the second letter is for the drive to hold the new
volume.
DISKCOPY A: B:
Archive disks may be copied to different disk formats as
long as the new disk has enough capacity to hold all
information on the source volume. Once archived, the
archive data cannot again be split across multiple archive
volumes.
The Context Sensitive Help System
STOWAWAY provides immediate help about its operation at
every point of its processing. A comprehensive help systems
may be interrogated at any time STOWAWAY is waiting for your
action by pressing the <F1> key. When <F1> is pressed,
STOWAWAY automatically determines what function is active
and action is being requested. It will search a help index
and retrieve information about your current activity. Help
systems that being up help about your current activity are
referred to as "context sensitive" meaning they are aware of
the context in which they are requested.
In addition to being context sensitive, STOWAWAY help system
is layered to let you not only examine help about your
current activity but also lets you browse through the help
displays to learn about related topics or other aspects of
STOWAWAY. Press the <Home> key any time you are in the help
system to display a help index.
The intelligent help system may be examined by using the
following navigation keys...
<Enter> Takes you to the next related screen
<Esc> Takes you back to the processing screen
<Alt> Allows you to peek back at the processing screen
to review what you are reading help about.
<PgUp> Will take you up to a more general topic in the
help system
68
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
<Home> Displays the main help menu
The LEFT, RIGHT, UP, and DOWN keys are available when
viewing screens smaller than the full page. Use them to
move the help window around on the display to view areas
hidden by the help window.
HARDWARE/SOFTWARE COMPATIBILITY
Operating system compatibilities
STOWAWAY must run on a 100% compatible PC, XT, or AT
system and requires DOS 3.1 or above for its operation.
STOWAWAY may operate on some other nonstandard systems
but we cannot guarantee its correct operation nor make
any promises to make it compatible with those systems.
Archive device compatibilities
STOWAWAY uses only standard DOS disk devices for
holding archive data. The obvious devices are various
forms of 3 1/2 and 5 1/4 diskette systems.
STOWAWAY is also designed to use large format removable
disk devices as archive media. These devices must have
a standard DOS format and must appear to DOS as a
normal disk device.
TROUBLESHOOTING
I/O errors on disks
If you should have a problem restoring data from a
damaged or faulty archive volume take the following
steps to attempt to circumvent the problem.
-- Try turning the disk in the sleeve with your
fingers to make sure it is loose and will
spin. If 5 1/4 diskettes appear too tight,
you can relieve some pressure placed on the
magnetic media by drawing each edge of the
diskette across the edge of a table applying
a reasonable amount of pressure. This will
expand the area inside the jacket for the
media to move.
69
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
-- Attempt to copy the diskette to another
diskette. If the copy is successful, attempt
to use the new disk to restore the data.
-- Take the volume in error to another drive on
another machine to attempt to restore the
data.
-- When all else fails, use the "FAIL" option
during archive volume read error detection to
indicate archive is to attempt to read as
much data as possible.
Error Messages
STOWAWAY has comprehensive error and exception checking
designed into every component of the system.
STOWAWAY's help systems contains help about messages
issued by STOWAWAY. Whenever an error message is
displayed, press the <F1> key for a complete
explanation of the error and suggested actions to take
as a result of the error.
Technical Support
Patri-Soft is located at the location shown below and may be
reached for technical support through a variety of sources.
Normal technical support hours are 8:30AM through 5:00 PM
Monday through Friday (PST).
You may contact us through the following methods...
CompuServe 76347,2477
Phone 714-352-2820
BBS 714-352-2825
FAX 714-352-1527
Mail:
Patri-Soft
5225 Canyon Crest Drive Suite 71-358
Riverside, CA 92507
A special order line is available if you would like to
purchase using VISA or MasterCard or discuss other purchase
options.
When calling for technical support please have the following
information ready so we may serve you efficiently:
70
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
a. The exact version of STOWAWAY you are using.
STOWAWAY main menu contains this data.
b. An exact problem description
c. screen print of the STOWAWAY directory and all
files it contains.
d. The software configuration of your system
including DOS version, AUTOEXEC.BAT contents as
well as CONFIG.SYS contents.
e. The hardware configuration of your system.
A good problem description indicates exactly what you were
doing when you encountered the error, and exactly what
symptoms occurred as a result of the error. Please avoid
the following problem descriptions. They are much too brief
to begin to analyze.
Poor problem descriptions:
a. Archive is not working.
b. The machine will not read my disk.
c. I can't restore my indexes
d. The system fails during archive or restore.
Following are examples of better problem descriptions:
a. Archive if failing. STOWAWAY asks for an archive
volume and after I place it in the drive, the
drive light comes on, goes off, and STOWAWAY
indicates no disk is in the drive.
b. I am attempting to restore indexes from an archive
volume and STOWAWAY indicates the indexes are not
present. I have displayed the contents of the
last used diskette and it appears to be ok. Its
contents are...
71
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
Index
/B . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
/BA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
/D:xxx . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
/DEL . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
/F:nnn . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
/ID:xxx . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
/ND . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
/S . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Age . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
ArcDate . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Archival Concepts . . . . . . . . . . . . . . . . . . . . . . 20
Archival vs Compression . . . . . . . . . . . . . . . . . . . 21
ARCHIVE
attribute . . . . . . . . . . . . . . . . . . . . . . . 35
file descriptions . . . . . . . . . . . . . . . . . . . 27
File Index . . . . . . . . . . . . . . . . . . . . . . . 23
File Selection . . . . . . . . . . . . . . . . . . . . . 28
Groups . . . . . . . . . . . . . . . . . . . . . . . . . 35
maintenance . . . . . . . . . . . . . . . . . . . . . . 66
Sets . . . . . . . . . . . . . . . . . . . . . . . . . . 22
volume preparing . . . . . . . . . . . . . . . . . . . . 25
Volumes . . . . . . . . . . . . . . . . . . . . . . . . 22
Archive File
descriptions . . . . . . . . . . . . . . . . . . . . . . . 9
Archive group
adding . . . . . . . . . . . . . . . . . . . . . . . . . 36
archive index
backup . . . . . . . . . . . . . . . . . . . . . . . . . 67
build from archive volume . . . . . . . . . . . . . . . 58
clean . . . . . . . . . . . . . . . . . . . . . . . . . 59
packing . . . . . . . . . . . . . . . . . . . . . . . . 57
Archive sets . . . . . . . . . . . . . . . . . . . . . . . . 66
Archive volume
copies . . . . . . . . . . . . . . . . . . . . . . . . . 67
Archive volumes
mount request . . . . . . . . . . . . . . . . . . . . . 38
Archiving files . . . . . . . . . . . . . . . . . . . . . . . 14
ArcSize . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
ArcTime . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Backup . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
BBS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Clean . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Colors . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Command Line . . . . . . . . . . . . . . . . . . . . . . . . 62
COMPATIBILITY
devices . . . . . . . . . . . . . . . . . . . . . . . . 69
72
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
Index
hardware . . . . . . . . . . . . . . . . . . . . . . . . 69
software . . . . . . . . . . . . . . . . . . . . . . . . 69
Compression . . . . . . . . . . . . . . . . . . . . . . . . 8, 21
CompuServe . . . . . . . . . . . . . . . . . . . . . . . . . 70
Date . . . . . . . . . . . . . . . . . . . . . . . . . . 34, 45
Days . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Delete
Files after archival . . . . . . . . . . . . . . . . . . 11
Description . . . . . . . . . . . . . . . . . . . . . . . . . 44
Directories
changing . . . . . . . . . . . . . . . . . . . . . . . . 15
disk
I/O error . . . . . . . . . . . . . . . . . . . . . . . 39
Disk Capacity . . . . . . . . . . . . . . . . . . . . . . . . . 8
Distribution diskette . . . . . . . . . . . . . . . . . . . . . 6
DOS Command . . . . . . . . . . . . . . . . . . . . . . . . . 47
DOS environment
SET STOW= . . . . . . . . . . . . . . . . . . . . . . . 13
DOS Verify . . . . . . . . . . . . . . . . . . . . . . . . . 10
Drive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Statistics . . . . . . . . . . . . . . . . . . . . . . . 29
Duplicate
file overlay . . . . . . . . . . . . . . . . . . . . . . 52
Duplicate Files
Overlay . . . . . . . . . . . . . . . . . . . . . . . . 12
Environment
variables . . . . . . . . . . . . . . . . . . . . . . . 65
Error Messages . . . . . . . . . . . . . . . . . . . . . . . 70
Expiration date . . . . . . . . . . . . . . . . . . . . . . . 10
Expiration Dates . . . . . . . . . . . . . . . . . . . . . . 23
FAX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Features . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
File descriptions . . . . . . . . . . . . . . . . . . . . . . 27
Freespace
archive until freespace . . . . . . . . . . . . . . . . 34
Group
Associating . . . . . . . . . . . . . . . . . . . . . . 16
option . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Help System
Help . . . . . . . . . . . . . . . . . . . . . . . . . . 68
I/O errors . . . . . . . . . . . . . . . . . . . . . . . . . 69
INSTALL . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Installation . . . . . . . . . . . . . . . . . . . . . . . . . 6
Locate text . . . . . . . . . . . . . . . . . . . . . . . . . 47
Menus
main . . . . . . . . . . . . . . . . . . . . . . . . . . 26
73
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
Index
Options
environment variables . . . . . . . . . . . . . . . . . 65
Overlay . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Overlaying
duplicate files . . . . . . . . . . . . . . . . . . . . 52
Pack . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Quick Start . . . . . . . . . . . . . . . . . . . . . . . . . 14
Replace
restore . . . . . . . . . . . . . . . . . . . . . . . . 53
Restore . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
group . . . . . . . . . . . . . . . . . . . . . . . . . 45
list . . . . . . . . . . . . . . . . . . . . . . . . . . 45
specifications . . . . . . . . . . . . . . . . . . . . . 43
Saving Archive index backup to disk . . . . . . . . . . . . . 40
Selecting
directory . . . . . . . . . . . . . . . . . . . . . . . 32
files . . . . . . . . . . . . . . . . . . . . . . . . . 18
group . . . . . . . . . . . . . . . . . . . . . . . . . 18
Groups . . . . . . . . . . . . . . . . . . . . . . . . . 29
Selecting files . . . . . . . . . . . . . . . . . . . . . . . 15
Sets
Archive . . . . . . . . . . . . . . . . . . . . . . . . 22
Sort . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
restore list . . . . . . . . . . . . . . . . . . . . . . 47
Sound . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Speaker . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Start new disk . . . . . . . . . . . . . . . . . . . . . . . 39
STOFILIX.DAT . . . . . . . . . . . . . . . . . . . . . . . . . 6
STOGRPIX.DAT . . . . . . . . . . . . . . . . . . . . . . . . . 6
STOSAWAY.DAT . . . . . . . . . . . . . . . . . . . . . . . . . 6
STOVOLIX.DAT . . . . . . . . . . . . . . . . . . . . . . . . . 6
STOW.EXE . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
STOW.HLP . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
SYSTEM
Setup . . . . . . . . . . . . . . . . . . . . . . . . . . 6
System options . . . . . . . . . . . . . . . . . . . . . . . . 7
Technical Support . . . . . . . . . . . . . . . . . . . . . . 70
TROUBLESHOOTING . . . . . . . . . . . . . . . . . . . . . . . 69
Update
restore . . . . . . . . . . . . . . . . . . . . . . . . 53
Utilities . . . . . . . . . . . . . . . . . . . . . . . . . . 54
build archive index . . . . . . . . . . . . . . . . . . 58
clean archive index . . . . . . . . . . . . . . . . . . 59
delete files . . . . . . . . . . . . . . . . . . . . . . 54
display colors . . . . . . . . . . . . . . . . . . . . . 60
pack the archive index . . . . . . . . . . . . . . . . . 57
remove files . . . . . . . . . . . . . . . . . . . . . . 54
74
STOWAWAY User's Guide Copyright 1991 by Patri-Soft
Index
verify archived files . . . . . . . . . . . . . . . . . 55
Verify . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
View . . . . . . . . . . . . . . . . . . . . . . . . . . 46, 47
Viewing files . . . . . . . . . . . . . . . . . . . . . . . . 16
Volumes
Archive . . . . . . . . . . . . . . . . . . . . . . . . 22
Zoom . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
75